home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
JCSM Shareware Collection 1996 September
/
JCSM Shareware Collection (JCS Distribution) (September 1996).ISO
/
butility
/
snap10.zip
/
MANUAL.TXT
< prev
next >
Wrap
Text File
|
1993-12-15
|
17KB
|
494 lines
+-----------------------------------------------------------------------------+
The line above should be centered and one-inch below the top of form.
- THE SNAPSHOT MANUAL TEXT FOLLOWS -
__________________________________
| |
| tm |
| SNAPSHOT UTILITY |
| |
| Copyright 1993 |
| |
| HFK Software |
| Sixty-Eight Wells Road |
| Lincoln, MA 01773 |
| |
| 617-259-0059 |
| |
|__________________________________|
Version 1.0
12-15-93
_______
_____|_ |
---| | |------------------(R)
| | O |
| O___|___ | Association of
| | |_| Shareware
|___| | Professionals
| O |
-------| | |--------------------
|___|___| Member
T A B L E o f C O N T E N T S
INTRODUCTION 1
SYSTEM REQUIREMENTS 1
INSTALLATION 1
SNAPSHOT LOADING 1
TRIGGERING 3
TAKING A SNAPSHOT 3
PREVIEWING A SNAPSHOT 4
AUTO-TYPING A SNAPSHOT 4
DISPLAY MODES 5
DYNAMIC HELP 5
SNAPSHOT REGISTRATION 5
SHAREWARE DECLARATION 6
REGISTRATION FORM 7
-- I N T R O D U C T I O N --
SNAPSHOT provides a means of taking electronic snapshots of
specific screen text areas and auto-typing the captured text
later upon demand. Up to ten snapshots may coexist.
Usually, screen data is captured while running one program
and then automatically typed via synthesized keystrokes to
provide input to another program. Since you do not rely upon
your memory, or notes, to capture the text displayed by the
first program; and, since you do not actually retype the
captured text; the data is always accurately input to the
second program without transposed characters or other typos.
SNAPSHOT also functions as a cut-and-paste facility within
the same program.
-- S Y S T E M R E Q U I R E M E N T S --
SNAPSHOT requires about 12K bytes of RAM plus buffers, and
runs under DOS Version-3 or later. The amount of RAM
required for buffers is specified below (see <capacity>).
-- I N S T A L L A T I O N --
SNAPSHOT installation is simple. Just copy the SNAPSHOT.COM
file onto your system disk.
-- S N A P S H O T L O A D I N G --
The SNAPSHOT TSR is loaded via a
SNAPSHOT <trigger> <number> <capacity>
command line either entered in response to the DOS prompt or
from your AUTOEXEC or other batch file.
<trigger> is specified as a combination of two shift key
names joined by a plus sign. Use "CTRL+ALT" for the CTRL and
the ALT keys held together, "LEFT+RIGHT" for both case shift
keys, "CTRL+LEFT" for the CTRL and the left case shift key,
etc.
-1-
<number> is the number of concurrent snapshots possible and
is specified in the range of 1-10.
<capacity> is the maximum number of characters that may be
captured by a snapshot, and is specified in the range of
20-2000 -- twenty characters to a full 25 by 80 screen.
SNAPSHOT's memory requirements are a function of the number
and maximum size of snapshots. Buffer requirements may be
computed using the following formula.
<buffer size> = (<capacity> + 10) * <number>
The minimum (<number>=1 and <capacity>=20) buffer requirement
is 30 bytes. This is probably too small for most uses, but
perhaps sufficient for a special case.
The maximum buffer requirement is ten full-screen snapshots
(<number>=10 and <capacity>=2000) or 20,100 bytes! This is
probably a gross waste of memory in most cases, but could be
required in a special case.
SNAPSHOT allows you to specify a <number> and a <capacity> to
suit your needs while avoiding wasted memory.
Sample SNAPSHOT command lines:
SNAPSHOT CTRL+ALT 1 20
SNAPSHOT LEFT+RIGHT 5 400
SNAPSHOT LEFT+CTRL 2 2000
SNAPSHOT RIGHT+ALT 10 2000
Running SNAPSHOT via one of the above command lines loads the
SNAPSHOT TSR which is an extension of DOS that uses about 12K
of RAM plus buffers.
Running SNAPSHOT again does nothing and results in "SNAPSHOT
TSR already loaded" being displayed; unless SNAPSHOT UNLOAD
is used, in which case the TSR is removed from memory and
SNAPSHOT may then be reloaded.
The ability to unload the SNAPSHOT TSR provides flexibility
for special cases. Normally SNAPSHOT is loaded once via a
line in the AUTOEXEC batch file and is never unloaded. If
you must unload SNAPSHOT, be certain to follow the convention
of unloading TSRs in reverse order (last loaded, first
unloaded).
-2-
-- T R I G G E R I N G --
Once the SNAPSHOT TSR has been loaded, it may be triggered
into action by depressing both trigger shift keys momentarily
and then releasing them.
Keystrokes following a trigger are intercepted by the TSR
until a DIGIT key is struck corresponding to one of the
concurrent snapshots. If <number>=5, then five concurrent
snapshots are possible and striking the "1" "2" "3" "4" or
"5" digit key: (1) terminates trigger input, (2) specifies
which snapshot, and (3) resumes normal program execution.
Note that the "0" digit key represents the tenth snapshot and
is not available unless the maximum number of snapshots have
been selected (<number>=10).
Striking ESCAPE anytime during a trigger, backs-out (cancels)
the trigger and resumes normal program execution.
SNAPSHOT triggering follows one of the following three
sequences:
(1) TAKING SNAPSHOT-<DIGIT>:
<trigger> [<arrows>] <SPACE> [<arrows>] <DIGIT>
- or using a mouse -
<trigger> [<move>] <click> [<move>] [<click>] <DIGIT>
(2) PREVIEWING SNAPSHOT-<DIGIT>:
<trigger> <?-key> <DIGIT>
(3) AUTO-TYPING SNAPSHOT-<DIGIT>:
<trigger> [U|L|F|W] <DIGIT>
-- T A K I N G A S N A P S H O T --
<trigger> <arrows> <SPACE> suspends the execution of the
running program and allows you to point to the upper left
corner of a text area of interest. More <arrows> and a
<DIGIT> are used to point to the lower right corner of the
text area, thus identifying the screen text to be captured
and which snapshot is to be taken.
A mouse is useful when pointing, but the arrow keys work
quite well.
-3-
-- P R E V I E W I N G A S N A P S H O T --
<trigger> <?-key> <DIGIT> suspends the execution of the
running program and displays the text captured during the
last Snapshot-<DIGIT> in the upper left screen area. This
display is maintained until the next trigger, ESCAPE, or
keyboard input, at which time the display is restored and
normal program execution is resumed.
-- A U T O - T Y P I N G A S N A P S H O T --
<trigger> <DIGIT> auto-types the text captured during the
last Snapshot-<DIGIT>. Non-keyboard characters are converted
to SPACEs but otherwise the text is keyed as captured with
one trailing SPACE.
<trigger> [U|L|F|W] <DIGIT> auto-types the text captured
during the last Snapshot-<DIGIT>, but with alterations per
the "U" "L" "F" or "W" key.
<trigger> <U-key> <DIGIT> auto-types Snapshot-<DIGIT>
with all characters forced to UPPER case.
<trigger> <L-key> <DIGIT> auto-types Snapshot-<DIGIT>
with all characters forced to LOWER case.
<trigger> <F-key> <DIGIT> auto-types Snapshot-<DIGIT>
with all characters forced to lower case except the
FIRST character, which is forced to upper case.
<trigger> <W-key> <DIGIT> auto-types Snapshot-<DIGIT>
with all characters forced to lower case except the
first character of each WORD, which is forced to
upper case.
While a snapshot often consists of a name, number, or phrase
that exists entirely on the same screen row, SNAPSHOT allows
you to capture a block of screen text consisting of several
(full or partial) rows in a single operation.
When you auto-type a snapshot that originated as a block of
text (more than one row), the captured text is normally
entered as a string of words and the fact that they
originated on separate lines is ignored; however, you may
preserve the block orientation by simply holding a case shift
(LEFT or RIGHT) key when striking the <DIGIT> key.
-4-
-- D I S P L A Y M O D E S --
AUTO-TYPING of captured text may be performed with the screen
operating in any display mode (25 by 80 text, 40-column, or
graphics).
DATA CAPTURE, HELP, AND PREVIEW require 25 by 80 text modes.
-- D Y N A M I C H E L P --
Once triggered, SNAPSHOT monitors the keyboard and mouse for
activity. If idle for one second, help text is popped-up to
describe the current input options. New and infrequent users
will find SNAPSHOT's help useful in leading them through the
taking of snapshots and the auto-typing of captured text.
However, you need not wait for the help information to be
presented. You will find that triggering and then completing
input quickly, minimizes screen activity and is a pleasant
way to use SNAPSHOT.
Help is available whenever needed by just pausing for a
second -- useful when necessary, but not disruptive for the
experienced user.
-- S N A P S H O T R E G I S T R A T I O N --
SNAPSHOT is provided as SHAREWARE. Enjoy experimenting with
and getting to know, and benefit from, SNAPSHOT.
Feel free to make copies for your friends and co-workers.
When you put SNAPSHOT to practical use, a small registration
fee is due. A convenient registration form follows.
When you register (via mail, fax or phone):
YOU PROVIDE and YOU RECEIVE
"Personalization text" to The registration codes to
replace UNREGISTERED USER personalize your copy of
(e.g., your personal or SNAPSHOT.
company name).
Twenty dollars ($20) via The right to put SNAPSHOT
check or MasterCard/VISA to productive use and to
account number/expiration receive support.
date/signature.
-5-
Note-1: This offer is subject to change without notice.
Note-2: Use of SNAPSHOT within a commercial product requires
a software license.
S H A R E W A R E D E C L A R A T I O N
This product is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that
the shareware principle works for you. If you are unable to
resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The
ASP Ombudsman can help you resolve a dispute or problem with
an ASP member, but does not provide technical support for a
members' products. You may contact the ASP Ombudsman via:
ASP Ombudsman
545 Grover Road
Muskegon, MI 49442-9427 USA
FAX: 616-788-2765
or
CompuServe Mail: ASP Ombudsman 70007,3536
HFK Software actively supports the goals and principles of
the Association of Shareware Professionals.
-6-
-- S N A P S H O T R E G I S T R A T I O N F O R M --
+-Personalization-Text:----------------------------------------------------+
| |
+-------------------------(10-35-characters-in-place-of-UNREGISTERED-USER)-+
+-MasterCard-or-VISA-Account-No:--------------+ +-Phone:------------------+
| | | |
+---------------------------------------------+ +-------------------------+
+-Exp:-----+ +-Signature:--------------------+ +-Fax:--------------------+
| | | ($20) | | |
+----------+ +-------------------------------+ +-------------------------+
--(fold-back-here)--------------(first-fold)--------------(fold-back-here)--
+-------+
From: ________________________________ | place |
| stamp |
________________________________ | here |
+-------+
________________________________
To: +------------------------------+
| |
| HFK Software |
| 68 Wells Road |
| Lincoln, MA 01773-3702 |
| |
+------------------------------+
--(fold-back-here)--------------(second-fold)-------------(fold-back-here)--
This form may be:
(1) folded and placed in a standard business window envelope;
(2) folded, taped, stamped, and mailed without an envelope; or
(3) FAXed to HFK Software at 617-259-0626.
Phone orders via: 617-259-0059
Massachusetts residents must include state sales tax.
